home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 351-375 / disk_363 / plw / plw.english.doc < prev    next >
Text File  |  1992-05-06  |  10KB  |  256 lines
  1.           Documentation for Phone Line Watcher Version 1.10
  2.  
  3. ****************************************************************************
  4. COPYRIGHT NOTICE:
  5.  
  6. © Copyright 1990 by Christian Fries. All rights reserved.
  7.  
  8. This program is NOT in the public domain. This program may NOT be distributed
  9. by any commercial software of hardware vendor.
  10. This program may ONLY be distributed by non-profit user groups, networks,
  11. bbs's, and of course by Fred Fish.
  12.  
  13. The Author cannot be liable for the use or misuse of this program.
  14. This copyright notice must be distributed with the program.
  15.  
  16. If you find this program useful please send $5 - $10 (or equivalent in
  17. other currency) to one of the following adresses:
  18.  
  19.    Christian Fries                      Christian Fries
  20.    c/o Fred Fries                       c/o Gudrun Horst
  21.    Ferdinand - Tietz Straße 19          77, Rue des Romains
  22.  
  23.    D 5500 Trier                         L 2443 Senningerberg
  24.  
  25. You will be registrated as User and get further Information about Updates
  26. and other Programs.
  27.  
  28.                                                      Christian Fries
  29.                                                    Trier, 7-April-1990
  30.  
  31. ****************************************************************************
  32.  
  33.  
  34.  
  35.  
  36. 1. Preface
  37.                                                               ®
  38. The Phone Line Watcher is an program for all owners of a Hayes-Compatible
  39. Modem. The program will protokoll all incomming calls with date, time and
  40. the amount of rings. It also offers the possiblity to let other modem owners
  41. 'log in' and leave a message.
  42.  
  43.  
  44.  
  45. 2. Protokolling of calls
  46.  
  47. The program protokolls all calls with date, time and the amount of rings
  48. into a file called 'PLW.protokoll'. To prevent the loss of data the file
  49. is only opend while the program adds new data to it (e.g. while a message
  50. comes in). Therefor the data is not lost on a system crash and you can
  51. view the protokoll file even while PLW is running (exept if a messages
  52. comes in or new data is stored). Data will be always append to the protokoll
  53. file and so you can view the protokoll of several sessions, beause the
  54. program will never delete that file but append the line
  55.           "Phone Line Watcher - Protokoll since [DATE] [TIME]"
  56. to the file on startup. So you should delete that file when you no longer
  57. need the old protokoll.
  58.  
  59.  
  60.  
  61. 3. The Menus
  62.  
  63. 3.1. Reset.
  64.  
  65. This Command resets the program (clears buffers, sets counters to zero) and
  66. the modem (according to the stuff specified in the Setup menu - see below).
  67.  
  68. 3.2. Setup.
  69.  
  70. This Command lets you specify certain parameters that are described below.
  71. The parameters are stored in 'S:PhoneLineWatcher.config'. These parameters
  72. are very important for PLW and should be specified with great care
  73. (especially the parameters that affect the setting of the modem).
  74. The parameters are:
  75.  
  76. - Ring Tolerance Time:
  77. The Program detects calls by the receiving of the 'RING' string from the
  78. modem. When it detects a rings it starts counting them. Then, when it there
  79. are no more 'RING' in the time intervall specified here PLW decsides that
  80. the caller hanged up and increases the call-counter while setting the ring-
  81. counter to zero. This time intervall is the 'Ring Tolerance Time' (specified
  82. in seconds).
  83. VALUE RECOMMENDED: 8 (seconds).
  84.  
  85. - AutoAnswer
  86. After this amount of 'RING's the program send the ATA command to the modem,
  87. that lets the modem go off-hook and send the answer-tone. You should set
  88. this number higher than 8 to prevent the bothering of innocent persons that
  89. don't like to 'log in' (and recognize after the 8th ring that theres no
  90. body at home). You are able to switch the log-in feature off by setting this
  91. number to zero.
  92. NOTE: If you set this number higher than 7 the caller has to set the modem-
  93. register 7 to a value of 60 or more (ATS7=10) to keep the modem trying (and
  94. not hang up after 30 seconds).
  95. VALUE RECOMMENDED: 0 (for no AutoAnswer).
  96.                   10 (for AutoAnswer after 10 RINGS).
  97.  
  98. - Maximum Online Time
  99. This number specifies the maximum amount of minutes that may the remote
  100. user look around inside your system. When the time is up the user will
  101. be disconnect even if he is about to leave a message.
  102. VALUE RECOMMENDED: 20 (minutes)
  103.  
  104. - Welcome File
  105. When the remote user is logged in the program will send this file.
  106. This file should be provided by you. This file has the same purpose
  107. than an spoken answer text on an phone-answer-machine (e.g. "I am
  108. shopping. Back at 15:00. Chris." or "On Vacation till 20 of March.
  109. Getting some sunshine. Chris.").
  110.  
  111. - Goodbye File
  112. When the remote user selected 'Exit' in his menu the program will send
  113. this file. Maybe you can use it for a more personal goodbye text than
  114. "DISCONNECTING".
  115.  
  116. - Master Password                                                  ®
  117. When a remote user is logged in he can select an access to AmigaDOS or view
  118. the protokoll (PLW.protokoll).
  119. This access is only permitted, if the user enters the Password specified
  120. here.
  121. NOTE: ACCESS TO AmigaDOS IS NOT IMPLEMENTED IN ANY VERSION LOWER THAN V1.20.
  122.  
  123. - Baud Rate
  124. Please enter here the Baudrate that will be used on the serial port on
  125. startup and when the reset is selected. Your modem should support that
  126. rate of course.
  127. NOTE: THE BAUD-RATE OF THE SERIAL PORT IS SET TO THAT BAUD-RATE AND AN
  128. AT FOLLOWED BY AN [CR] (ASCII: 13) IS SEND TO THE MODEM.
  129. VALUE RECOMMENDED: 300, 1200, 2400, 4800, 9600 (depends on your modem)
  130.  
  131. - 1st InitString
  132. This string is send to the modem after startup or after selecting reset
  133. followed by an [CR] (ASCII: 13).
  134. VALUE RECOMMENDED: AT or AT&F or ATZ (depends on your modem).
  135.  
  136. - 2nd InitString
  137. This string is send to the modem after startup or after selecting reset
  138. followed by an [CR] (ASCII: 13).
  139. VALUE RECOMMENDED: ATV1X4
  140.                    ATB0V1X4 (for CCITT standard).
  141.                    ATB1V1X4 (for BELL standard).
  142.  
  143. - Init delay time
  144. This is the number of seconds between the sending of InitString1 and
  145. InitString2.
  146. VALUE RECOMMENDED: 1 (second)
  147.  
  148. 3.3. Language.
  149.  
  150. PLW supports diffent languages. Currently ENGLISH and GERMAN (DEUTSCH) are
  151. supported. Please select the language you prefere in the submenu.
  152. The language on startup is always english.
  153.  
  154. 3.4. View
  155.  
  156. View shows the contens of the PLW.protokoll file. To hold the dispay
  157. simply hold the right mousebutton.
  158.  
  159. 3.5. About
  160.  
  161. Try is out.
  162.  
  163. 3.6. Exit
  164.  
  165. Frees all devices (timer, serial, console), frees memory, and shuts down
  166. the program.
  167.  
  168.  
  169.  
  170. 4. The login-feature
  171.  
  172. The login-feature displays a menu to the remote user. PLW accepts ASCII
  173. characters to edit the entered data (e.g. DELETE or BACKSPACE). Also it
  174. accepts the amiga console device commands (like CURSOR-KEYS - see RKM¹ for
  175. more. As CSI¹ $9B is accepted.) to edit the entered data.
  176. NOTE: USAGE OF console.device COMMANDS MAY CAUSE THE PROGRAM TO EXIT,
  177. WHEN CSI IS CONVERTED TO ESCAPE (HI-BIT SET TO ZERO).
  178.  
  179. The following features are available in this Version to the remote user:
  180.  
  181. - leaving a message
  182. To leave a message the remote user has always the possiblity to edit
  183. one line (80 characters). After the end of the line is reached or the
  184. user hit [RETURN] (ASCII: 13) the data will be stored. The transmission
  185. of the message is terminated by hitting ESCAPE (ASCII: 27).
  186.  
  187. - viewing the protokoll file
  188. To use the feature you have to enter the passord specified in the setup
  189. menu. This is to prevent other people of 'viewing' personal messages.
  190.  
  191.  
  192.  
  193. 5. Comming Soon (maybe):
  194.  
  195. * Transmission of Files in both direction (XMODEM).
  196. * Access to AmigaDOS with a Password from remote.
  197.  
  198.  
  199.  
  200. 6. Modem specific data:
  201.                                                 ®
  202. The program assumes, that you are using an Hayes-Compatible modem. The program
  203. was tested with BEST and DISCOVERY modems. You have the posibility to adjust
  204. certain things by using the 1st and 2nd Init-String. Although some commands
  205. are send to the modem directly by the program and you cannot change them.
  206. Here is the list of commands the program uses. If you find out, that the
  207. program does not work with you modem, because of these commands (maybe your
  208. modem is a little bit incompatible) than you may contact me to change these.
  209.  
  210. String            | Direction  | Function
  211. --------------------------------------------------------------------------
  212. RING[CR]          | From Modem | Incomming call.
  213.                   |            | Increases the ringcounter.
  214. CONNECT[CR]       | From Modem | Set serial interface to 300 Baud and start
  215.                   |            | comunication with remote.
  216. CONNECT 1200[CR]  | From Modem | Set serial interface to 1200 Baud and start
  217.                   |            | comunication with remote.
  218. CONNECT 2400[CR]  | From Modem | Set serial interface to 2400 Baud and start
  219.                   |            | comunication with remote.
  220. CONNECT 4800[CR]  | From Modem | Set serial interface to 4800 Baud and start
  221.                   |            | comunication with remote.
  222. CONNECT 9600[CR]  | From Modem | Set serial interface to 9600 Baud and start
  223.                   |            | comunication with remote.
  224. NO CARRIER[CR]    | From Modem | Engage reset procedure.
  225.                   |            | (Not even neccesary).
  226. ATA[CR]           | To Modem   | Answer call (Go off hook and send carrier-
  227.                   |            | tone).
  228. +++               | To Modem   | Set the modem to Command mode (a pause of 3
  229.                   |            | seconds precedes and follows this sting).
  230. AT[CR]            | To Modem   | Set the modems Baudrate to the one used by 
  231.                   |            | the serial interface.
  232. ATH0[CR]          | To Modem   | Hangup.
  233.  
  234.  
  235.  
  236. 7. Bugs:
  237.  
  238. * Extremly wrong specified parameters may cause trouble.
  239.  
  240.  
  241.  
  242.  
  243.  
  244.          Thanks to A. Soldo and H. Kopp for additional bug testing.
  245.  
  246.  
  247. Notes:
  248.  
  249. ¹ RKM: Amiga ROM Kernal Reference Manual.
  250.        Addison-Wesley Publishing Company, Inc.
  251.  
  252.   CSI: Console sequence introducer.
  253.  
  254.  
  255.  [CR]: ASCII-Character (code: 13).
  256.